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[INTRODUCTION 


This manuat provides an introduction to and an overview of Burroughs 

B 1800/8 17u0 GEneralized Message COntrol System (GEMCOS). fhe primary 
purpose of this manual 1s to provide data processing managers with 
enough information about GEMCOS to determine its usefulness in their 
own environgent.- what GEMCOS can do and why GEMCOS provides these 
capabilities are describeds very littie is said regarding how GEMCOS 
does these things. The use of technical terminology is minimal. A 
general data processing or data communications background would be 
helpful» but not necessary» to understand GEMCUS as described herein. 


Section 1 of this manual contains a discussion of the need for and the 
functions ot message control systems (MCSs) in on-line systems in gen- 
eral and in Burroughs 8B 1800/8 1700 Systems in particular. I[t is hoped 
that this section provides the technically uninitiated with a reason- 
able perspective on how the MCS fits into the total on-line environment 
and how it relates to other componentss such as application programs,» 
the data base manayement system» and the network controtter. 


Section 2 describes the general benefits of GEHMHCOS and the major 
capabilities of the two versions of GEMCOS. Sections 3 and 4 describe 
in greater uetail the capabilities of the two verstons: The Basic 
Version (style identification numbers B1800 MCB and B1700 MCB)» and 
the Advanced Version (style identification numbers B1800 MCA and 

B1700 MCA). 


The technically oriented reader may learn more about GEMCOS and the 
B 1800/B 17.0 Systems onvline environment in general by referring to 
the following Burroughs manuals: 


ae B if00 Generalized Message Control System (C(GEMCOS) User's 
Manual» form 1093499. 


be. B af00 Systems System Software Operation Guides form 1068731. 


c- B if00 Systems Network Definition Language (NDL) Reference 
Manual» form 1073/15. 


de B if00 Systems User Programming Language CUPL) Reference 
Manual» form 1067170. 


e- B if00 Systems COBOL Reference Manuals form 1057197. 


f. B 1700 Systems Report Program Generator (RPG) Reference 
Manuals form 1057189. 


ge B if00 Systems FORTRAN. Reference Manuals form 1081882. 
These manuais are Listed approximately in order of relative importance 


With respect to GEMCOS. Those which refer only to the B 1700 system 
apply equatiy to the B 1800 System. 


SECTION 1 


MESSAGE CONTROL SYSTEMS 


ON-LINE COMPLEXITIES. 

As business data processing has evolved toward on-line processing in a 
multitask environment (multiple programs running concurrently)» pro- 
gramming couplexities have increased by an order of magnitude. They 
involve pro.ulems such as: 


ae Preventing two or more programs from updating the same 
record simultaneously. 


b. Preventing unauthorized access to programs and/or data 
baseSe 


ce Encoding data properly for transmission to or from the 
network. 


d.- Maintaining orderly communication between the computer 
anu devices in the networks even when several devices 
share the same Line to cut communications costs. 


ee. Ensuring that messages from the network and from programs 
running in the central system are properly routed to 
their destinations. 


f. Auciting Cwriting to disk or tape) of messages and data 
base transactions. 


ge Recovery of running programs» data bases» and messages or 
transactions in the event of a failure. 


he. Formatting data appropriately for each hardware device in 
the network. 


This list is not exhaustiver but suggests the kind of problems which 
must be considered in an on-line» multitask environment and which did 
not even exast in the single program batch systems of the past. 


BURROUGHS Oiy-LINE SOFTWARES 

If application programmers had to address all these problems in their 
programs» tne simplest application would become unbelievably complex. 
Fortunately» a better way has been found. Software modules speci fi- 
cally designed to relieve the application programmer of these burdens 
have evolvec. These modules and their interrelationships are shown in 
figure inl. 


Data base Management systems coordinate access to the data base and 
recover the data base after a failure. 


The network controller transmits and receives messages to and from the 
network. This function often involves code conversion and may involve 
message auditing. In Burroughs Systems» the network controller program 
is generateug from a description of the network in Network Definition 
Language (NUL). 


The message control system (MCS) interfaces with the network controller 
and with the application programs. As shown in figure 1-2» the MCS 
exerts control over both the network environment and the program 
environment. HCS functions may include the following: 


ae Message routing. 

be Access control. 

Ce AuUdit/message restoration. 
d- System management. 

e. Message formatting. 
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Figure 1-1. On-Line Software 
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Figure 1°72. The Role of the MCS 
The MCS and network controller together relieve the applications 
programmer of: 


ae Line control (Ce-ege» connect/disconnect» polling and 
adoressing»s timing» error detection and retransmission). 


be Line ouffer allocation and control. 
ce. Recovery from abnormal conditions. 
de Terminal interfacing. 

e.- Network control. 

ff. Message routing. 


g- Access control. 


he Message auditing. 
1- Message formatting. 


In short» acl the application programmer must worry about is the 
requirements of his application and maintaining a simplee standard 
interface with the MCS. 


CANDE» RJE» and GEMCOS are examples of MCSs available in the 
B 1800/8 if.vd0 Systems. 


CANDE 1s a special-purpose MCS which facilitates on-line program 
development and testing. Using CANDE from a time-sharing terminals a 
programmer can enters» edit» compiler debuge and execute a program very 


conveniently. 


RJE (Remote Job Entry) is another special-purpose MCS designed to 
facilitate running batch jobs from remote locations. 


GEMCOS 1s an MCS which is meant to run in a transaction-oriented>» 


on-line processing environment. Its features and capabilities are 
described in sections 2 thru 4. 
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SECTION 2 


8B 1800/8 1700 GEMCOS 


GENERAL BENEFITS- 


GEMCOS is a transaction~oriented MCS designed to provide a flexible 
user interface that does not compromise efficiency: 


ae It provides the data communications user with a viable 
interface between the network controtler and the application 
programs which process transactions from on-line terminals. 
GEMCOS and the network controller work together to relieve 
application programs Cand programmers) of the numerous compli 
cated considerations inherent tn an on-line environment. The 
design of application programs is thus independent of the 
environment in which they operate» a feature which protects 
a user's investment in these programs. 


b. As illustrated in figure 271» GEMCOS and DMS II can work 
toyether to insulate application programs from the complexi- 
ties of the network and the data base» respectively. Of 
courses either can operate independently of or without the 
otner. 


ce GEmCOS conserves personnel time and effort because it is 
reiatively easy to instali and interface. 


GEMCOS is aiso a flexible MCS.» It provides users of B 1800/8 1700 
Systems with a tool for tailoring network control to meet their spe- 
cific requirements. GEMCOS accommodates a broad range of throughput 
and processing cequirements. GEMCOS is also an on-going mechanism for 
continuous network control in the dynamic environment of data commu- 
nications systems. As application-oriented requirements change or 

new hardware opportunities arise» the user employs GEMCOS to adapt to 
changes in: 


ae Central site hardware configuration. 

b. Central site software structure. 

ce Network configuratione including terminal changes. 
d- <Apzplication/data base design. 


GEMCOS VERSIONS. 

To accommodate the small user as well as larger» more complex in- 
Stailations» GEMCOS is available in two versions: The Basic Version 
and the Advanced Version. The major capabilities of each of these 
versions are: 


ae Basic Version GEMCOS: 


1) Transaction Control Language. 
2) Access control. 

3) Message routing. 

4) Message auditing. 

5) Network control. 

6) Message restoration. 


7) Nontpartticipating MCS. 
be. Advanced Version GEMCOS: 


i) Alt Basic Version capabilities. 
2) Message formatting. 


More information about GEMCOS capabilities is provided in the remainder 
of this manual. Section 3 describes Basic Version GEMCOSs sections 3 
and 4 describe Advanced Version GEMCOS. 
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Figure 271. GEMCOS/DMS II Relationship 
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SECTION 3 


BASIC VERSION GEMCOS 


The fotlowtng major capabilities of Basic Version GEMCOS are discussed 
in this section: Transaction Control Language» access control» message 
routings message auditing» network control» and Message restoration. 
Gther assorted features provided in the Bastc Version are also 
discussed. 


The various environments under which an MCS could operate dictated that 
a sia@ple method for describing requirements unique to a user's specific 
eavironment be developed. Both the requirements and the environment 
are expecteu to be dynamic. GEMCOS adapts to differing needs by 
permitting a user to describe his requirements in TCL. 


In all GEMCLS versions» TCL is used to describe criteria ranging from 
message"routing criterias and access~control requirements to message 
formats and a variety of other GEMCOS options. 


The Language has a free-form structures using key words to describe both 
the environswent and the requirements of the data communications user. 
The result of a TCL compilation is a set of customized tables. (The 

TCL compiler optionaltiy provides a hard-copy record of the data commu- 
nications system description.) The MCS code which interprets those 
tables is mcdular in structure. The GEMCOS design is totally compatible 
with the virtualcmemory concept. 


The TCL exauple shown in figure 3-1 is a complete description of a very 
Simple system consisting of two stations and one program. 


ACCESS CONTROL. 


Access control is optionally available on a station-by-station basis. 
If it is declared to be in effect for a given stations the legitimate 
users of that station can be specified. A valid sign-on procedure at 
the station must be followed to gain access to the system. Specific 
Limitations on types of transactions entered or programs used by any 
user signing on may also be specified. Thus» using the standard access 
control feacures» GEMCOS may be instructed to allow access to a spe- 
cific list of transactions and/or programs on a user=byc-user basis. 
Moreover» each user is restricted to a specific set of stations. An 
example foliows. 


Suppose “ABC123" 1s one of several access keys employed in a system. 
Persons assigned A&C123 are to be restricted to the use of only station 
STA7. They are to be further restricted to the use of only message 
keys UPD ang INQ. fo implement these restrictions» the following two 
statements would appear in the access control section and station 
section of the TCL deck» respectively: 


ACCESSCONTROL = 

ACCESSKEY ABCi23 = UPD» INQ. 
STATION STA?C7): 

VALIDUSERS = ABC1i23. 
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COMMENTS 


CONTROL = LIST, CAUSES TCL REPORT TO BE PRINTED. 


GENERATE. CAUSES NEW TABLES AND MCS SOURCE 
CODE TO BE GENERATED. 


GLOBAL: 


CONTROL STATIONS = TTY1. TTY1 1S PERMITTED TO ENTER NETWORK 
CONTROL COMMANDS. 


BEGIN 
PROGRAM PRGM1 USER: PRGM1 IS CLASSIFIED AS A USER 


PROGRAM CAPABLE OF PROCESSING 4 
DIFFERENT TRANCODES. 
TITLE = SAMPLE/USER/PGM. SPECIFIES NAME OF CODE FILE. 
TRANCODE = KEY1. TRANSACTION CODES WHICH WILL 
TRANCODE = KEY2. CAUSE MESSAGES TO BE ROUTED TO 
TRANCODE = INQUIRE. PRGM1. 
TRANCODE = UPDATE. 
STATION TTY1: THE MCS WILL CONTROL STATIONS 
STATION TD801: TTY1 AND TD801. 


END. 


Figure 3-1. ICL Description of 
Data Communications Network 


MESSAGE ROULING.- 


Several 
GEMCOS. 


Be 
D. 
Ce 


types of message routing are provided by the Basic Version of 
Messages can be routed from: 


Station to application program. 
Application program to station. 
Station to station. 


When a destination station is out of services an alternate station may 
be specifieu by using a network control command. 


The three methods available to ailow messages to be routed from stations 
to programs are: 


ae A program may attach itself to a set of stations (a remote 
file) and messages entered at those stations witt be routed 
to the attaching program. 


b. A Station may attach itsetf to a program and messages entered 
at the attaching station will be routed to the program. 


ce Transaction codes may be associated with prcgrams so that when 
a message containing a particular transaction code is entered 
at a stetion, the message 1S routed to the program defined to 
process that transaction. 


User programs Can address output to specific stations on a station-by- 
station basis. If a user program takes no action to speciticatty route 
a responses the wessage is routed to the sender of the input message. 


By ustng a network control command» users at stations can route 
messages to other stations Cor the supervisory console). 


MESSAGE AUDITING. 

The GEMCGS Basic verston wilt, 1f requested, create an audit file of 
messages as they pass through the mcS.~ Alt messages which are entered 
from stations and are bound for application proarams (1.e. messages 
which coutd be applied to a data dase) can Ce audited. In additions 
alt messages bound for stations may be audited. The message auditing 
function is used py the message restoration function to aid programs 
during data base recovery. 


NETWORK CONTAOL. 
In order to dynamicaliy control the data communications processing 
environments, the user may designate a particular station as a network 
control station. <A network controt station is priviledged in that it 
May enter commancs which may reconfigure and/or manage the network. 
For example, a network control station may make stations ready» make 
stations not reacy, Change a Station maximum retry counts change a 
statton alternate station, change a station adcress» start and stop 
programs,» bring Gown the syStemse etc. GEMCOS notifies the network 
control station of various exception conditions as they occur. The 
supervisory console may act as a network control station, 


Networx control alsc allows Stations in the network to make various 
inquiries to GEMCOS» route messages to other stationsse attach them- 
selves to progranss etc. 


The Network Control function accumulates changes made to stations in 
the network in a disk file. If GEMCOS 1s haltea and then re~mexecutede 
GEMCOS automatically reconfigures the network cack tec its Last runnirg 
state regardless of the fact that the network controtter may have 
forgotten which changes had occurred. 


MESSAGE BESTCRATION. 

In coordination with the message auditing capability» message 
restoration can aid application programs during data base recovery. 

The Message Restoration function allows any application program to spe 
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cify the hast message it has processed. GEMCOS will send allt messages 
which were sent to the program after the Last known message to have 
been processed by the programa. If a data hase has been rolled back 
during a recovery processs the application programs can request to be 
sent alt messages which occurred after a particular checkpoint. 


A_MIXED OR NON PARTICIPATING MCSe 

Applications which require such features as routing by transaction code 
or auditing must necessarity have an MCS that is capable of examining 
and monitoring ail the messages passing through the datacomm system. 

In applications where such features are not requireds it is desirabte 
to relieve the MCS from the overhead of examining each message. To 
accommodate this» the GEMCOS systema offers the user the option of 
creating a non participating MCS. A non participating MCS has the 
functions of network control, communication errors and ail forms of 
message routing except routing By transaction code. 


Application systems whereby it @S deSirabile to have the MCS partici- 
pating in the messages of some programs and not others, the GEMCOS 
system provides the user with the option of creating a mixed parti- 
cipating MCS. A mixed participating MCS provides att the features 
of a fully participating MCS to those application programs which 
require them while at the same time providing minimai overhead of a 
non participating MCS to the other apptication programs. 


SUPERVISORY MCS 

In a system where more than one WCS 138 concurrently executinge such 

as GEMCOS» CANDE or ODESYs it is a desirable feature to have the 
ability to atilow terminals to interface with more than one MCS. To 
accommodate thisse GEMCOS has the ability to act as a "supervisory™ MCS. 
A "supervisory" MCS has the following functions: controt the atltioca= 
tion and reassignment of terminats to other MCS*s» atlow terminais to 
switch from one MCS to another and gaintain overatt controt of the 
datacomm system. 


The fall ouins a ausan onal features are atso provided in the GEMCOS 
Basic Verstons: 


ae A variety of statistical information concerning stations» 
programs.» and GEMCOS is available to the user in a realtime 
modes This data can help the user fine tune the system 
following initial tmplement at ion. 


b. GEMCOS detects, diagnoses, and recovers from a variety of 
data communications error situations. 


ce. Fixed data relating to a particular transaction type may be 
automatically passed to application programs by GEMCDS» based 
upon TCL specifications. 


A Screen Wraparound function is available in GEMCOS. The 
function causes output messages which would be too targe 


for the buffer of the destination station to pe automaticatty 
segmented and sent in several transmissions. 


Programs may be designated as core or disk resident to allow 
the user to help the system make more effective use of memory. 


GEMCOS can run in a sitmulation mode without a network controt- 
ler in the mix. 


Network control commands may be entered via a card reader. 


GEMCOS 1s not restricted to any particutar set of stations. 
It can work with any or all of the stattons defined in the 


network controtter. 


GEMCOS contains an optionat monitor trace feature. The 
monitor trace 3s a very useful debugging aid which creates 

a listing on a tine printer displaying messages as they pass 
through the MCS» their sources destinations and the procedures 
of the MCS which were tnvoked to process them. 


User written UPL procedures can be merged into GEMCOS to 
supplement and/or replace standard GEMCOS functions. 


GEMCOS ts capabte of interfacing application programs written 
in COBOL» FORTRAN» RPGs» and UPL. 


GEMCOS wiil optionally send messages to application programs 
whenever it adds or removes a station from the apptication'ts 
file. Thais in turn attows each apptication program to keep 
track of the stations it ts currently interfacing with. 
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SECTION 4& 


ADVANCED VERSION GEMCOS 


In addition to all the Basic Version capabilities» Advanced Version 
capabilities include message formatting. Message formattingse unique 
to the Advanced Versione is discussed in this section. 


MESSAGE FORMATTING. 


Formatting of messages is independent of user programs. A uSer writing 
an application program 1s not required to know hardware control codes 
or buffer capacity for the various terminals in the network. Rather» 
the application programmer can deal with the data strings at the point 
of program interface. A user independently describessr in ICLe a format 
descriptions used by GEMCOS to format those data strings. 


GEMCOS retrieves format descriptionss based upon both message identi- 
fication key and the device class of the station involved» and applies 
the format to the data. This allows tremendous flexibility at the 
Stations» transparent to the application programmer. For examples the 
application program can tell GEMCOS to send an identical message to 
two stations in the network. If those two stations are in different 
device classes» the output messages may be formatted using two differ= 
ent format cescriptions provided in ICL» resulting in drastically 
different outputs delivered to the stations. Such data-field charac- 
teristics as lengthe sequences and related form information can vary 
from station to station for an output message destined for multiple 
Stations. Conversely» two different stations can supply input for the 
same type of transaction under different formats» and the data will 
arrive at the application program ina standard format. Such activity 
is transparent to the application program. 


Some of the other capabilities of GEMCOS formatting include: 
ae Forms retrieval. 


be Format modification without compilation of application 
prugrams. 


Ce Nu@eric field verification. 


d- Handling of variable length fields» with zero/space fill 
anu right/left justification. 


ee. Data translation. 


The example in figure 4-1 shows how a message which appears fixed in 
format to a user program may look quite different at each of several 
Stations which may send or receive the message. It is emphasized that 
this example applies equally well to input (message sent from program 
to station). <A different format would be used for each of the three 
screens. 


SCREEN 1: 


MSG KEY [TC10] 


NAME [JOHN DOE], 


SSN [484603151] 


DATE OF BIRTH [09/04/48] 


SCREEN 2: 


MSG KEY [TC10] 


GEMCOS USER 
FORMATTER PROGRAM 


NAME {[DOE, JOHN] 


SSN [484-60-3151] 


BIRTH DATE [SEPT 4, 1948] 
MESSAGE AS IT APPEARS TO PROGRAM 


TCIOJOHN DOE 484603151090448 


an ain ; ye 
MSG BIRTH 
ery NAME SSN baTE 


SCREEN 3: 


MSG KEY [TC10] 
NAME [DOE, JOHN] 


BIRTH [48 SEPT 4] 


SSN [484603151] 


Figure 4-1. Rearrangement of 
Output Fields 
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